package com.apigen.platform.service;

import com.apigen.platform.entity.SysUser;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;

import java.util.List;

/**
 * 系统用户服务接口
 *
 * @author API Generator
 * @since 2024-09-24
 */
public interface ISysUserService extends IService<SysUser> {

    /**
     * 根据账户名查询用户
     *
     * @param accountName 账户名
     * @return 用户信息
     */
    SysUser getByAccountName(String accountName);

    /**
     * 根据邮箱查询用户
     *
     * @param email 邮箱
     * @return 用户信息
     */
    SysUser getByEmail(String email);

    /**
     * 根据手机号查询用户
     *
     * @param phone 手机号
     * @return 用户信息
     */
    SysUser getByPhone(String phone);

    /**
     * 分页查询用户列表
     *
     * @param page 分页参数
     * @param accountName 账户名（模糊查询）
     * @param nickName 昵称（模糊查询）
     * @param email 邮箱（模糊查询）
     * @param isEnabled 是否启用
     * @return 用户列表
     */
    IPage<SysUser> getUserPage(Page<SysUser> page, String accountName, String nickName, String email, Boolean isEnabled);

    /**
     * 根据角色ID查询用户列表
     *
     * @param roleId 角色ID
     * @return 用户列表
     */
    List<SysUser> getUsersByRoleId(Long roleId);

    /**
     * 创建用户
     *
     * @param user 用户信息
     * @return 创建结果
     */
    boolean createUser(SysUser user);

    /**
     * 更新用户信息
     *
     * @param user 用户信息
     * @return 更新结果
     */
    boolean updateUser(SysUser user);

    /**
     * 删除用户
     *
     * @param userId 用户ID
     * @return 删除结果
     */
    boolean deleteUser(Long userId);

    /**
     * 批量删除用户
     *
     * @param userIds 用户ID列表
     * @return 删除结果
     */
    boolean deleteUsers(List<Long> userIds);

    /**
     * 启用/禁用用户
     *
     * @param userId 用户ID
     * @param enabled 是否启用
     * @return 操作结果
     */
    boolean enableUser(Long userId, boolean enabled);

    /**
     * 重置密码
     *
     * @param userId 用户ID
     * @param newPassword 新密码
     * @return 重置结果
     */
    boolean resetPassword(Long userId, String newPassword);

    /**
     * 更新用户最后登录信息
     *
     * @param userId 用户ID
     * @param loginIp 登录IP
     * @return 更新结果
     */
    boolean updateLastLoginInfo(Long userId, String loginIp);

    /**
     * 检查账户名是否存在
     *
     * @param accountName 账户名
     * @param excludeUserId 排除的用户ID
     * @return 是否存在
     */
    boolean existsAccountName(String accountName, Long excludeUserId);

    /**
     * 检查邮箱是否存在
     *
     * @param email 邮箱
     * @param excludeUserId 排除的用户ID
     * @return 是否存在
     */
    boolean existsEmail(String email, Long excludeUserId);

    /**
     * 检查手机号是否存在
     *
     * @param phone 手机号
     * @param excludeUserId 排除的用户ID
     * @return 是否存在
     */
    boolean existsPhone(String phone, Long excludeUserId);

    /**
     * 统计用户数量
     *
     * @param isEnabled 是否启用
     * @return 用户数量
     */
    int countUsers(Boolean isEnabled);
}
